Release 10.1A: OpenEdge Development:
Progress 4GL Reference

SET-BUFFERS( ) method

Binds all buffers for a query or dynamic ProDataSet object at the same time. Any buffers previously added to the ProDataSet object are removed.

Use the ADD-BUFFER( ) method to add one buffer to the object, without affecting the other buffers, if any.

Return type: LOGICAL

Applies to: ProDataSet object handle, Query object handle

Syntax

SET-BUFFERS ( buffer [ , buffer ] ... )

buffer

A handle to a buffer, or a CHARACTER expression that evaluates to the name of a buffer that Progress searches for at runtime.

The maximum number of buffers per query is 18.

Note: Searching for a buffer using a handle is more efficient than a character expression. Progress resolves a character expression at runtime by searching in the current routine for a static buffer with that name. If not found, Progress searches the enclosing main procedure. If still not found, Progress searches up through the calling programs of the current routine, and their main procedures. Since a handle uniquely identifies the buffer, no such search is required.

Following is an example:

my-query-handle:SET-BUFFERS(BUFFER customer:handle).

For more information on buffer objects and query objects, see OpenEdge Development: Progress 4GL Handbook .